home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 11 / QRZ Ham Radio Callsign Database - Volume 11.iso / files / packet / ax25ip.shr / README < prev    next >
Text File  |  1998-02-02  |  4KB  |  105 lines

  1. STATUS:
  2. Tested on a Sun3/60 and a Sun4/260 running SunOS4.1.1, using a PacComm
  3. Tiny-2 TNC, and talking with other NOS sites in Calgary, Alberta.
  4.  
  5. INSTALL:
  6. 0. Substitute the name 'KERNEL_CONFIG_FILE' in the following steps with the
  7.    kernel configuration file for your new kernel (If in doubt, make a copy
  8.    of GENERIC, and use it).
  9.    Also, substitute 'sun3' with whatever the command 'arch -k' says
  10.    your kernel architecture is.
  11.  
  12. 1.  First, you need to add the device driver to the kernel. Add this line to
  13.     /usr/sys/sun3/conf/KERNEL_CONFIG_FILE.
  14.     pseudo-device   ax1             init ax_attach
  15.               ^ this number determines how many TNCs you can hook up.
  16.  
  17. 2.  splice these sections in the appropriate (fairly obvious) places in
  18.     /usr/sys/sun/str_conf.c
  19.     #include "ax.h"
  20.  
  21.     #if     NAX > 0
  22.     extern struct streamtab axinfo;
  23.     #endif
  24.  
  25.     #if     NAX > 0
  26.             { "ax25",       &axinfo },
  27.     #endif
  28.  
  29. 3.  add this line to /usr/sys/conf.common/files.cmn
  30.     os/tty_ax.c             optional ax
  31.  
  32. 4.  Install the needed files in the kernel sys tree
  33.     # cp tty_ax.c /usr/sys/os
  34.     # cp if_ax.h /usr/include/sys
  35.     # cp if_ax.h /usr/sys/sys
  36.  
  37. 5.  Build the kernel
  38.     # cd /usr/sys/sun3/conf
  39.     # config KERNEL_CONFIG_FILE
  40.     # cd ../KERNEL_CONFIG_FILE
  41.     # make
  42.     # mv /vmunix /vmunix.save
  43.     # cp vmunix /vmunix
  44.  
  45. 6.  Reboot your machine to start up the new kernel.
  46.  
  47. 7.  Now, build the two user level programs: ax25ether and ax25, and give
  48.     it a try.
  49.     # make
  50.  
  51. 8. Put your hostname in /etc/hosts with the correct IP address.
  52.     44.135.145.28    ve6uug-0
  53.  
  54. 9.  Ensure that the netmask for network #44 is correct. Ussually it should
  55.     be 0xffffff00. Put that in /etc/netmasks, like this.
  56.     44    255.255.255.0
  57.    (If you are running YP, you may need to rebuild the databases.
  58.     # (cd /var/yp; make)
  59.    )
  60.  
  61. 10. Ensure your TNC is in KISS mode, with the proper KISS timing parameters
  62.     already set. Now we can start up the interface.
  63.  
  64.     # ./ax25 -v ve6uug-0 ve6uug-0 /dev/ttyb
  65.     popping module: ttcompat
  66.     popping module: ldterm
  67.     pushing module: ax25
  68.     network device: ax0
  69.     addresses: ax25 ac.8a.6c.aa.aa.8e.60 'VE6UUG-0' = ether 99:da:55:b5:d6:70
  70.     execute: ifconfig ax0 ve6uug-0 netmask + broadcast + up
  71.     Setting netmask of ax0 to 255.255.255.0
  72.  
  73.     The first instance of your callsign is resolved according to /etc/hosts
  74.     to generate an IP address. The second instance of your callsign determines
  75.     what your AX25 hardware address is, which is what other parties use to
  76.     actually send a packet to your hardware.
  77.  
  78. 11. Check to see if the interface has come up.
  79.     # netstat -in
  80.     Name  Mtu  Net/Dest      Address        Ipkts  Ierrs Opkts  Oerrs Collis Queue
  81.     le0   1500 136.159.222.0 136.159.222.1  3871    0    1847    0    0      0
  82.     lo0   1536 127.0.0.0     127.0.0.1      339     0    339     0    0      0
  83.     ax0   1000 44.135.145.0  44.135.145.28  0       0    0       0    0      0
  84.  
  85. 12. Try to talk to a few other hosts, ie. telnet, finger, etc.
  86.  
  87. BUGS:
  88. Generally, etherfind seems to work, but only on the second and successive
  89. attempts. The first attempt fails with an NIOCBIND error. No idea why.
  90.  
  91. Packets with digipeater addresses in their header are dropped on the floor
  92. immediately. Proper digipeater support cannot be easily added. (My opinion:
  93. digipeating is a dumb idea).
  94.  
  95. DTR behaviour: M_HANGUP and M_UNHANGUP streams messages are not handled
  96. correctly. Currently, it's best to <snip> your TNC's DTR line.
  97.  
  98. OTHER NOTES:
  99. The kernel ARP routines can only deal with 6 byte ethernet addresses. A
  100. bizzare encoding scheme is used to encode AX25 7-byte addresses into these
  101. 6-byte addresses. When AX25 addresses are converted, the resulting ethernet
  102. addresses always have their upper byte set to 0x99. The program ax25ether
  103. will convert between AX25 addresses and ethernet addresses as shown using
  104. the arp command.
  105.